home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 10 / AACD 10.iso / AACD / Online / SpeakFreely / src / adpcm / readme < prev    next >
Text File  |  2000-05-18  |  3KB  |  85 lines

  1. This directory contains version 1.2 of a simple 16 bit PCM <-> 4 bit
  2. ADPCM coder and decoder. See the source and the manpage for comments
  3. on the algorithm.
  4.  
  5. If you have previously used version 1.0: there was a bug in it. This
  6. version fixes the bug. (1.1 fixed that, but had another slight bug
  7. that caused loss of quality on SGI machines).
  8.  
  9. The routines have been tested on an SGI Indigo running Irix 4.0.2 and
  10. 4.0.5F and on a Sun Sparc SLC running SunOS 4.1.1. There are no real
  11. machine dependencies, though, so there should be no problems on other
  12. architectures. 
  13.  
  14. There is a timing program to test how fast the stuff runs on your
  15. machine. Here are some sample numbers:
  16.  
  17. R4000 Indigo:    compress: 1.1Msample/sec, decompress: 1.7Msample/sec
  18. R3000 Indigo:    compress: 410Ksample/sec, decompress: 850Ksample/sec
  19. Sun SLC:    compress: 250Ksample/sec, decompress: 420Ksample/sec
  20. Mac-IIsi    compress   21Ksample/sec, decompress:  35Ksample/sec
  21.  
  22. I'd be interested in numbers for PC class machines.
  23.  
  24. Also included are some simple test programs that convert audio files
  25. to/from 4bit ADPCM samples. Rawcaudio/rawdaudio convert to/from raw
  26. 16bit PCM files; sgicaudio/sgidaudio convert to/from SGI AIFF files
  27. and suncaudio/sundaudio convert to/from SUN/NeXT format audio files.
  28. The Sun program was donated by Hughes Doug, hughes@sde.mdso.vf.ge.com
  29. (it is actually only one program and looks at the program name to
  30. decide whether to compress or decompress). Oh yeah, the sun and sgi
  31. compressors will probably only compile on those machines. Also, for
  32. the sgi compressor you need the Digital Media Developers Option, which
  33. (I think) is available with Irix 4.0.5.
  34.  
  35. Note: I have had to make a few changes to the sun audio converter, but
  36. unfortunately I have no way of testing the result (since it needs
  37. Solaris 1.somethingorother which I don't have). If the program does
  38. not work and someone fixes it I would like to get a copy.
  39.  
  40. Finally, there is a uuencoded adpcm sound file of me saying "hello
  41. world" (with a cold) that you can use to test that everything works
  42. correctly.
  43.  
  44. If you use this package I would like to hear from you.
  45. I am especially interested in people who can test interoperability
  46. with proven Intel/DVI ADPCM coders. I have tried to get the algorithm
  47. correct, but you never know....
  48.  
  49. Answers to often-asked questions:
  50. - No, this is *not* a G.721 coder/decoder. The algorithm used by G.721
  51.   is very complicated, requiring oodles of floating-point ops per
  52.   sample (resulting in very poor performance). I have not done any
  53.   tests myself but various people have assured my that 721 quality is
  54.   actually lower than DVI quality.
  55.  
  56. - No, it is not a CDROM-XA coder either, as far as I know. I haven't
  57.   come across a good description of XA yet.
  58.  
  59. - No, testc and testd are not full-blown audio-file converters, only
  60.   simple test programs. If you write a file-converter (like caudio.c,
  61.   which compresses Sun audio files) and you're willing to donate it
  62.   I'd be very happy to include it in the distribution.
  63.  
  64. - Also, I know next-to-nothing about who IMA are. Their address, though,
  65.   from their May 1992 proceedings (where I got the algorithm from):
  66.     IMA Compatability Project Headquarters
  67.     9 Randall Court
  68.     Annapolis MD 21401
  69.     USA
  70.  
  71.     Phone: (410) 626-1380
  72.     Fax:   (410) 263-0590
  73.  
  74. They might be able to send back issues of their proceedings, I don't
  75. know.
  76.  
  77.     Jack Jansen
  78.     Centre for Mathematics and Computer Science
  79.     Kruislaan 413
  80.     Amsterdam
  81.     the Netherlands
  82.  
  83.     +31 20 592 4098
  84.     Jack.Jansen@cwi.nl
  85.